Funds movement messages

Description

Returns monitoring message records for major-player funds movement on centralized exchanges for spot or futures trading of a specified token.

Use cases:

• Query messages during AI real-time tracking for tokens in the funds movement monitoring list
• View historical funds movement signal records, including but not limited to short-term/trend movements, Alpha, FOMO, take-profit, stop-loss, etc.

Tips:

• Display signal type names; when multiple alpha, fomo, etc. messages appear, count occurrences of each type and give special reminders when they appear together
• Call this API after natural-language queries for movement tokens or movement signals
• Use together with the funds movement token list API; call this API only when querying signals for tokens in that list

Data refresh: Updated every 5 minutes

Endpoint

• Method: POST
• Path: /open/v1/ai/getFundsCoinMessageList

Points

• Points per call: 5

Prerequisites

Obtaining vsTokenId

Condition	Description	How to obtain
Already have vsTokenId	Use the cached vsTokenId directly; no need to query again	Extracted automatically from context
Do not have vsTokenId	Call POST /vs-token/list	Prerequisite API call

Request parameters

Parameters are sent in the request body as JSON.

Parameter	Type	Required	Description
vsTokenId	long	Yes	Token ID
tradeType	integer	Yes	Trade type (1: spot, 2: futures)

Enum reference

tradeType — trade type

Value	Meaning
1	Spot
2	Futures

Response fields

Field structure for each object in the data array only:

Field	Type	Actual serialized type	Description
updateTime	long	long	Update time (millisecond timestamp)
vsTokenId	long	string	Token ID
symbol	string	string	Token symbol
name	string	string	Name
tradeType	integer	integer	Token type (1: spot; 2: futures; 3: delivery futures)
price	number	string	Token price
percentChange24h	number	number	24-hour price change
fundsMovementType	integer	integer	Funds movement type

Field semantics

Field	Business meaning	Usage suggestion
fundsMovementType	Funds movement type	Identifies movement types such as short-term movement, trend movement, Alpha, etc.; give special reminders when multiple types occur at the same time; do not display signal type mappings

Request example

{
    "vsTokenId": 22974,      // Token ID
    "tradeType": 1           // Trade type (1: spot, 2: futures)
}

cURL example (Linux/macOS)

curl --location --request POST 'http://${host}/api/open/v1/ai/getFundsCoinMessageList' \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: xxxxx' \
--header 'X-TIMESTAMP: xxxxx' \
--header 'X-SIGN: xxxxx' \
--header 'Accept: */*' \
--data-raw '{
    "vsTokenId": 22974,
    "tradeType": 1
}'

cURL example (Windows CMD)

curl --location --request POST "http://${host}/api/open/v1/ai/getFundsCoinMessageList" ^
--header "Content-Type: application/json" ^
--header "X-API-KEY: xxxxx" ^
--header "X-TIMESTAMP: xxxxx" ^
--header "X-SIGN: xxxxx" ^
--header "Accept: */*" ^
--data-raw "{    \"vsTokenId\": 22974,    \"tradeType\": 1}"

Sample success response

{
    "code": 200,
    "message": "success",
    "data": [
        {
            "updateTime": 1773395700000,       // Update time
            "vsTokenId": "22974",                // Token ID
            "symbol": "TAO",                      // Token symbol
            "name": "Bittensor",                  // Name
            "tradeType": 1,                       // Token type (1: spot; 2: futures; 3: delivery futures)
            "price": "241.4",                     // Token price
            "percentChange24h": 15.36477852,      // 24-hour price change
            "fundsMovementType": 6                // Funds movement type (6: upside move)
        },
        {
            "updateTime": 1773395400000,
            "vsTokenId": "22974",
            "symbol": "TAO",
            "name": "Bittensor",
            "tradeType": 2,
            "price": "240.2",
            "percentChange24h": 4.56494468,
            "fundsMovementType": 3
        },
        {
            "updateTime": 1773395400000,
            "vsTokenId": "22974",
            "symbol": "TAO",
            "name": "Bittensor",
            "tradeType": 2,
            "price": "240.2",
            "percentChange24h": 15.6226012,
            "fundsMovementType": 1
        }
        // ... more items omitted
    ],
    "requestId": "xxx-xxx-xxx"
}